home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / print / gs261ini.zip / USE.DOC < prev    next >
Text File  |  1993-05-29  |  25KB  |  672 lines
  1.    Copyright (C) 1989, 1992 Aladdin Enterprises.  All rights reserved.
  2.  
  3. This file is part of Ghostscript.
  4.  
  5. Ghostscript is distributed in the hope that it will be useful, but
  6. WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
  7. to anyone for the consequences of using it or for whether it serves any
  8. particular purpose or works at all, unless he says so in writing.  Refer
  9. to the Ghostscript General Public License for full details.
  10.  
  11. Everyone is granted permission to copy, modify and redistribute
  12. Ghostscript, but only under the conditions described in the Ghostscript
  13. General Public License.  A copy of this license is supposed to have been
  14. given to you along with Ghostscript so you can know your rights and
  15. responsibilities.  It should be in a file named COPYING.  Among other
  16. things, the copyright notice and this notice must be preserved on all
  17. copies.
  18.  
  19. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  20.  
  21. This file, use.doc, describes how to use the Ghostscript language
  22. interpreter.
  23.  
  24. For an overview of Ghostscript and a list of the documentation files, see
  25. README.  
  26.  
  27. ********
  28. ******** How to install Ghostscript ********
  29. ********
  30.  
  31. To run Ghostscript, you need the executable program, and also some
  32. external initialization files:
  33.     gs_*.ps (gs_dps1.ps, gs_fonts.ps, gs_init.ps, gs_lev2.ps,
  34.          gs_statd.ps, gs_dbt_e.ps, gs_sym_e.ps)
  35.     uglyr.gsf
  36.     Fontmap
  37.  
  38. The file name of the executable program depends on the environment;
  39. see the instructions for the specific platforms below.
  40.  
  41. The Ghostscript fileset includes a set of fonts (.gsf files); you
  42. should have them on line as well.
  43.  
  44. VMS
  45. ---
  46.  
  47. Installing Ghostscript on a VMS system requires compiling it first.
  48. The name of the executable is GS.EXE.
  49.  
  50. You should install all the files, including the fonts, in the same
  51. directory as the executable and initialization files.  By default,
  52. this is the directory in which you did the compilation.  Consult the
  53. command file (VMS-CC.MAK or VMS-GCC.MAK) for more details.
  54.  
  55. If you have DECWindows/Motif installed, you may wish to replace the
  56. FONTMAP file with the file FONTMAP.VMS.  Read the comment at the
  57. beginning of the latter file for more information.
  58.  
  59. MS-DOS
  60. ------
  61.  
  62. There are two MS-DOS executables in the standard Ghostscript
  63. distribution:
  64.     - GS.EXE runs on any MS-DOS machine, but is limited to 640K.
  65.     - GS386.EXE runs on any 386 or 486 machine, and will use all
  66. available extended (not expanded) memory.
  67.  
  68. You should install all the files except the fonts in C:\GS, and the
  69. fonts in C:\GS\FONTS.
  70.  
  71. If you have Adobe Type Manager fonts installed on your system, and you
  72. wish to use them with Ghostscript, you may wish to replace the FONTMAP
  73. file with FONTMAP.ATM, and to add to the environment variable GS_LIB the
  74. name of the directory where the fonts are located (see below for more
  75. information about GS_LIB).  Before you do this, please read carefully the
  76. license that accompanies the ATM fonts; Aladdin Enterprises takes no
  77. responsibility for any possible violations of such licenses.
  78.  
  79. MS Windows
  80. ----------
  81.  
  82. The name of the executable is GSWIN.EXE.  Ghostscript requires Windows
  83. 3.1, and you must run Windows in 386 Enhanced or Standard (not Real) mode.
  84. Since Ghostscript is a large program, you will need to run Windows in
  85. Enhanced mode (so that it can provide virtual memory) unless you have at
  86. least 6 Mb of RAM.
  87.  
  88. You should install all the files except the fonts in C:\GS, and the
  89. fonts in C:\GS\FONTS.
  90.  
  91. See under "MS-DOS" above for information about using Adobe Type
  92. Manager fonts with Ghostscript.
  93.  
  94. OS/2 2.0
  95. --------
  96.  
  97. Ghostscript currently only runs in an OS/2 DOS Box.  Please read the
  98. MS-DOS notes, since they apply to this environment as well.
  99.  
  100. If you run GS386 in the OS/2 2.0 DOS Box, you must select the
  101. "ENABLED" setting for the DPMI_DOS_API option of the DOS Box.  GS386
  102. will not run with the "AUTO" setting.
  103.  
  104. Unix
  105. ----
  106.  
  107. Installing Ghostscript on a Unix system requires compiling it first.
  108. The name of the executable is gs.  The makefile installs all the
  109. files, except the fonts, in /usr/local or various subdirectories
  110. thereof.  The fonts should be installed in
  111. /usr/local/lib/ghostscript/fonts.  Consult the makefile for more
  112. details.
  113.  
  114. ********
  115. ******** Shell scripts for Ghostscript
  116. ********
  117.  
  118. The Ghostscript distribution includes several Unix shell scripts for
  119. driving Ghostscript in different environments.  These are all
  120. user-contributed code: please contact the user identified in the file, not
  121. Aladdin Enterprises, if you have questions.
  122.  
  123. > pv.sh - preview a specified page of a dvi file in an X window.
  124.  
  125. > sysvlp.sh - System V 3.2 lp interface for parallel printer.
  126.  
  127. > pj-gs.sh - printing on an H-P PaintJet under HP-UX.
  128.  
  129. > unix-lpr.sh - queue filter for lpr under Unix.
  130. > lprsetup.sh - setup for unix-lpr.sh.
  131.  
  132. If one of these serves your needs, you may be able to skip most of
  133. the rest of this document.
  134.  
  135. ********
  136. ******** How to use the Ghostscript interpreter ********
  137. ********
  138.  
  139. To invoke the interpreter, give the command
  140.     gs <filename1> ... <filenameN>
  141. The interpreter will read in the files in sequence and execute them.
  142. After doing this, it reads further input from the primary input stream
  143. (normally the keyboard).  Each line (i.e. characters up to a <return>) is
  144. interpreted separately.  To exit from the interpreter, type quit<return>.
  145. The interpreter also exits gracefully if it encounters end-of-file.
  146. Typing the interrupt character, e.g., control-C, is also safe.
  147.  
  148. The interpreter recognizes several switches described below, which may appear
  149. anywhere in the command line and apply to all files thereafter.
  150.  
  151. You can get a help message by invoking Ghostscript with
  152.     gs -h
  153. or
  154.     gs -?
  155. This message also lists the available devices.  For a little more
  156. information, a one-line description of each device appears near the
  157. beginning of the file devs.mak.
  158.  
  159. Choosing the output device
  160. --------------------------
  161.  
  162. Ghostscript may be built with multiple output devices.  Ghostscript
  163. normally opens the first one and directs output to it.  To use device xyz
  164. as the initial output device, include the switch
  165.     -sDEVICE=xyz
  166. in the command line.  Note that this switch must precede the first .ps
  167. file, and only its first invocation has any effect.  For example, for
  168. printer output in a normal configuration that includes an Epson printer
  169. driver, you might use the shell command
  170.     gs -sDEVICE=epson myfile.ps
  171. instead of just
  172.     gs myfile.ps
  173. Alternatively, you can type
  174.     (epson) selectdevice
  175.     (myfile.ps) run
  176. All output then goes to the printer instead of the display until further
  177. notice.  You can switch devices at any time by using the selectdevice
  178. procedure, e.g.,
  179.     (vga) selectdevice
  180. or
  181.     (epson) selectdevice
  182. As yet a third alternative, you can define an environment variable
  183. GS_DEVICE as the desired default device name.  The order of precedence for
  184. these alternatives, highest to lowest, is:
  185.     selectdevice
  186.     (command line)
  187.     GS_DEVICE
  188.     (first device in build list)
  189.  
  190. To select the density on a printer, use
  191.     gs -sDEVICE=<device> -r<xres>x<yres>
  192. For example, on a 9-pin Epson-compatible printer, you can get the
  193. lowest-density (fastest) mode with
  194.     gs -sDEVICE=epson -r60x72
  195. and the highest-density mode with
  196.     gs -sDEVICE=epson -r240x72.
  197. On a 24-pin printer, the lowest density is
  198.     gs -sDEVICE=epson -r60x60
  199. and the highest-density 24-pin mode is
  200.     gs -sDEVICE=epson -r360x180
  201.  
  202. If you select a printer as the output device, Ghostscript also allows you
  203. to control where the device sends its output.  Normally, output goes
  204. directly to the printer (PRN) on MS-DOS systems, and to a scratch file on
  205. Unix or VMS systems.  To send the output to a series of files foo1.xyz,
  206. foo2.xyz, ..., use the switch
  207.     -sOutputFile=foo%d.xyz
  208. (For compatibility with older versions of Ghostscript, -sOUTPUTFILE=
  209. also works.)  The %d is a printf format specification; you can use
  210. other formats like %02d.  Each file will receive one page of output.
  211. Alternatively, to send the output to a single file foo.xyz, with all
  212. the pages concatenated, use th